package org.convallaria.infrastruct.db.entity;

import com.baomidou.mybatisplus.annotation.*;
import com.fasterxml.jackson.annotation.JsonFormat;
import lombok.Data;

import java.io.Serial;
import java.io.Serializable;
import java.time.LocalDateTime;

/**
 * 企业级基础实体类
 * 包含所有实体的公共字段，符合企业级项目标准
 * 
 * 设计原则：
 * 1. 支持多租户数据隔离
 * 2. 支持软删除机制
 * 3. 支持乐观锁并发控制
 * 4. 支持数据审计追踪
 * 5. 支持业务状态管理
 * 6. 支持数据来源标识
 * 
 * @author convallaria
 * @since 1.0.0
 */
@Data
public abstract class BaseEntity implements Serializable {

    @Serial
    private static final long serialVersionUID = 1L;

    /**
     * 创建时间
     * 记录数据创建的时间戳
     */
    @TableField(value = "create_time", fill = FieldFill.INSERT)
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private LocalDateTime createTime;

    /**
     * 更新时间
     * 记录数据最后修改的时间戳
     */
    @TableField(value = "update_time", fill = FieldFill.INSERT_UPDATE)
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private LocalDateTime updateTime;

    /**
     * 创建人
     * 记录数据创建者的用户标识
     */
    @TableField(value = "create_by", fill = FieldFill.INSERT)
    private String createBy;

    /**
     * 更新人
     * 记录数据最后修改者的用户标识
     */
    @TableField(value = "update_by", fill = FieldFill.INSERT_UPDATE)
    private String updateBy;

    /**
     * 删除标志（0=正常 1=删除）
     * 支持软删除机制，符合企业级数据安全要求
     */
    @TableLogic(value = "0", delval = "1")
    @TableField(value = "del_flag")
    private Integer delFlag;

    /**
     * 乐观锁版本号
     * 支持高并发场景下的数据一致性控制
     */
    @Version
    @TableField(value = "version")
    private Long version;

    /**
     * 备注信息
     * 支持业务备注
     */
    @TableField(value = "remark")
    private String remark;
}
